Skip to content

API Issues #373

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

API Issues #373

wants to merge 6 commits into from

Conversation

mrdavidorok
Copy link
Collaborator

Description

Provide a brief overview of what this documentation update is about. Explain what sections or topics are being added or revised.

Linear ticket and magic word Fixes DEVR-942

Type of change

  • Typo fix
  • New feature
  • Enhancement to current docs
  • Removed outdated references
  • Update assets

Copy link

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@mrdavidorok mrdavidorok marked this pull request as ready for review June 8, 2025 07:51
@github-actions github-actions bot requested a review from PoojaB26 June 8, 2025 07:51
Copy link
Collaborator

@PoojaB26 PoojaB26 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requested changes, please see the comments.


Follow the steps below:

- **Set Proper Request Headers**
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are steps, should this be numbered bullets or dot bullets?


`Content-Type: application/json`

`Charset: utf-8`​
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are two headers that needs to be added, shouldnt there be bullets?


This guide will help you understand the most common API error codes and how to fix them.

## What is an API?
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this sub topic and add a single line about APIs such as To learn more about APIs, check out our API documentation guide and point it to our API docs. You can find it if you search for it. Please reference other guides to learn how we hyperlink internal docs.

Your request isn’t properly formatted. This could be due to a missing parameter, a typo, or incorrect syntax.

:::tip
Check the API documentation to ensure you're including the correct fields and headers.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Check the API documentation to ensure you're including the correct fields and headers.
Check the API's own documentation to ensure you're including the correct fields and headers.

The API server took too long to respond. Try simplifying your request or reducing the size of the data being sent.

:::tip[Final tips]
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider.
- Always check the API's own documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider.


:::tip[Final tips]
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider.
- Once you fix the issue, your calls should return a `200 OK`—which means everything is working as expected!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Once you fix the issue, your calls should return a `200 OK`which means everything is working as expected!
- Once you fix the issue, your calls should return a `200 OK`, which means everything is working as expected!

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Refrain from using double dashes in our documentation, please change everywhere.


Ensuring the security of API keys is a critical aspect of building and maintaining a safe and reliable application. In the realm of private API calls, it's especially important to make sure your API keys are not exposed. This article aims to provide a best-practices guide on where to place your API keys to increase security in a FlutterFlow environment.​

## The Misconception: Private API Calls Secure Everything
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this doesnt need to be h2, just bold heading is fine.


Many users assume that simply marking an API call as 'private' is enough to protect all associated data. However, this is not the case. Private API calls run in a Cloud Function, which means any keys or sensitive data in the body will be secure — as long as they're not passed in from the frontend. Even in private API calls, if you're loading an API key from the frontend (like from Firebase remote configs), then you're still exposing it.​

## Where to Put Your API Keys
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not a good title, please think of an alternative

```
The key should never be a variable that gets passed in from the frontend, as that would make it accessible via the client-side code, defeating the purpose of using private API calls for secure operations.

## How to verify that your key is secured
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Refrain from using "How to" in titles , update the title accordingly and all our titles are written in Title Case.

slug: /understanding-api-errors
title: Understanding API Errors
---
# Understanding API Errors
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Whats the difference between this doc and client server errors doc? seems like similar info, merge the info and create a single doc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants